##############################################################################
###+---------+################################################################
#+-| LTRIM() |------------------------+#######################################
#| +---------+ Removes leading blanks |#######################################
#+------------------------------------+#######################################
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------------+#############################
#|     FUNCTION CHAR ltrim PROTOTYPE            |#############################
#|      PARAMETERS CONST CHAR source_string     |#############################
#+----------------------------------------------+#############################
##############################################################################
##############################################################################
###################+---| Description |--------------------+###################
###################| The ltrim() function removes leading |###################
###################| blank characters from source_string. |###################
###################+--------------------------------------+###################
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########|                                                          |#########
#########| ? ltrim( "     John & Celine Lowrey" )                   |#########
#########| *---- returns: "John & Celine Lowrey"                    |#########
#########|                                                          |#########
#########| ? ltrim( chr(12)+"      Start       " )                  |#########
#########| *---- no change occurs to string                         |#########
#########|                                                          |#########
#########| ? ltrim( space(90) )                                     |#########
#########| *---- returns: NULL string                               |#########
#########+----------------------------------------------------------+#########
##############################################################################